Transformer Class: 


SlToVtAddProductTransformer 


Description: This class directs the data transformation from the Siebel Add Product system event to the 


Vitria Add Product business event. The Siebel Controller Class vi^ill invoke this class when the Add Product 


system event is received from the Siebel Servlet Source. This class will perform two main functions: 


1 . Invoke the SlIDLBuilder class to transform data from the Siebel Integration Object format to IDL format 


(Please refer to the IDL Detail Design document for IDL format.) 


2. Return information in IDL format to the Siebel Controller Class to be published to a channel 


Class Variables: 


None 


Instance Variables: 


None 


Method(s): 


1. perform Work 




Description: This method will transform the Vitria Product business 




component fields retrieved for the Add Product system events to IDL 




fields to be published by Vitria. 


Method Details 




Exception: 


1. Type: AcknowledgementException 




Description: This contains the account id, business event, external 




application, success indicator, element, element id, error message, bpid 




and eventXML. 


Parameter(s): 


1. Name: pEventBody 




Type: EventBody 




Description: The eventBody parameter holds the event specifications 




such as the name of the event, and the parameters of the event. 




2. Name: pSti 




Type: SimpleTranslatorlnterface 




Description: The SimpleTranslatorlnterface contains the log level and is 




used this to write log messages to the appropriate log file. 


Event Body Parameter(s): 


1. Name: SiebelMessage 




Type: SiebelMessage Event 




Description: The SiebelMessage parameter contains two sub parameters 




i.e , a sequence of Product Instance struct and attributes of the Siebel 




Message event. 


Return Value(s): 


1. Name: eventBody 




Type: EventBody 



Controller Class: PlController 

Description: The Portal Controller (PlController) class will be developed to direct the business events from 
Vitria to the correct transformer class. Each business event has a different process that needs to be performed 
to create the appropriate system events. There are two fimctions that this class performs: 

1. Directs events to the appropriate transformer class. Each business event will have a separate transformer 
class that will process the business event into the appropriate system event 

2. The system event (i.e. vtOpCode event) is received back from the transformer class. This class will then 
return the event to the connection model to be sent to the next flow (Portal Target Flow). 

Class Variables: None 
Instance Variables: None 

Method(s): 1 . getTargetEventlnterfaceList 

Description: This method is a public static method which will set the 
default input Event Interfaces for the Data Transformation flow when the 
PlController class is selected. 

2 . getSourceEventlnterfaceList 

Description: This method is a public static method which will set the 
default output Event Interfaces for the Data Transformation flow when the 
PlController class is selected. 

3 . targetTranslation 

Description: This method will decide what transformer class corresponds 
to the input event. The transformer name and event are then passed to the 
callTranslation method. The targetTranslation method will be a public 
method. 

4. callTranslation 

Description: This method will du-ect the event to the specified event 
transformer class and call the applicable transformer method. The 
callTranslation method is a private method within this class. 

5. sourceTranslation 

Description: This method overrides the sourceTranslation method in the 
superclass. We must include this method in the PlController class because 
it is declared as abstract in the BaseControUer. However, we will not 
perform any actual data manipulation at this time, so we will simply return 
null. 

6. getEventXML 

Description: This method will retrieve the source event, and translate it 
into a xml string. 

Method Details 

1, getTargetEventlnterfaceList 
Exception(s): None 
Paranieter(s): 1. Name: strMethodName 

Type: String 

Description: The name of the method which was selected by the user 
within the Processing Tab for a Simple Transformer in the Vitria BW 
console. 

2. Name: translateParams 
Type: String[] 

Description: This parameter is not used in this method, but is required by 
Vitria B W to implement this method. 

7. Name: resolver 
Type: MetaResolver 

Description: The MetaResolver handles the switch between editable and 
registered versions of the event list. 
Return Value(s): 1. Name: eventBody 

Type: EventBody 



2 . getSourceEventlnterfaceList 




Exception(s): 


None 


Paraineter(s): 


1, Name: strMethodName 




Type: String 




Description: The name of the method which was selected by the user within 




the Processing Tab for a Simple Transformer in the Vitria BW console. 




2. Name: translateParams 




Type: String[] 




Description: This parameter is not used m this method, but is required by 




Vitria BW to implement this method. 




3. Name: resolver 








Description: The MetaResolver handles the switch between editable and 




registered versions of the event list. 


Return Value(s): 


None 


3. targetTranslation 




Exception(s): 


None 


Parameter(s): 


1. Name: eventBody 




Type: EventBody 




Description: The eventBody parameter holds the event specifications such as 




the name of the event, and the parameters of the event. 




2. Name: sti 




Type: SimpleTranslatorlnterface 




Description: Use this to write log messages to the appropriate log file and 




retrieve the log level. 


Return Value(s): 


Name: SystemEvent 




Type: EventBody 


4, callTranslation 




Exception(s): 


None 


Paranieter(s): 


1. Name: eventBody 




Type: EventBody 




Description: The eventBody parameter holds the event specifications such as 




the name of the event, and the parameters of the event. 




2. Name: sti 




Type: SimpleTranslatorlnterface 




Description: SimpleTranslator to retrieve log level and write log messages. 


Return Value(s): 


Name: SystemEvent 




Type: EventBody 


5. sourceTranslation 




Exception(s): 


None 


Parameter(s): 


1. Name: eventBody 




Type: EventBody 




Description: The eventBody parameter holds the event specifications such as 




the name of the event, and the parameters of the event. 




2. Name: sti 




Type: SimpleTranslatorlnterface 




Description: SimpleTranslator to retrieve logger instance and log level. 


Return Value(s): 


None 



6. getEventXML 




Exception(s): 


None 


Parameter(s): 


1 Name: sti 




Type: SimpleTranslatorlnterface 




Description: SimpleTranslator to retrieve logger instance and log level. 


Return Value(s): 


Name: xmlEvent 




Type: String 



Acknowledgement Class: 


SlAcknowledgementTransformer 


Description: This class directs and transforms the Siebel Response Message that results from the completion 


of a Service Status Notification or Update Product Status event to an Acknowledgement business event. 


The Siebel Controller Class will invoke this class when the Siebel Response Message is received from the 


Siebel Target Driver. This class will perform two main frmctions: 


1 . Transform information from a Siebel business component format to an IDL format. 


(Please refer to the IDL Detail Design document for IDL format.) 


2. Return information in an IDL format to the Siebel Controller Class to be passed to the Acknowledgement 


unannei. 




Class Variables: 


None 


Instance Variables: 


None 


Metiioa(s): 


1 . perform Work 




Description: This method will transform the incoming Siebel Response 




iVicSbage UllU IxJx^ ilCiCla lU DC pUUllMlCU 111 V 111 id. 


Metnoa Details 




Exception: 


1. Type: AcknowledgementException 




Description: This contains the account id, business event, external 




application, success indicator, element, element id, bpid, and eventXML 


Parameter(s): 


1. Name: pEventBody 




Type: EventBody 




Description: The eventBody parameter holds the event specifications 




such as the name of the event, and the parameters of the event. 




2. Name: pSti 




Type: SimpleTranslatorlnterface 




Description: Use this to write log message to the appropriate log file. 


Incoming Siebel 




ResultsEvent Body Parameters; 


1. Name: status 




Type: String 




Description: The status field is either Success or Error, indicating 




whether the event was processed correctly. 




2. Name: error 




Type: String 




Description: The error field contains any error message that occurred 




while processing the Siebel operation. 


Return Values: 


1. Name: eventbody 




Type: EventBody[] 



Transformer Rules for Account 



TT\T 

IDL 


Siebel 


Portal 


Field Name 


Integration 
Object Field 
Name 


Transformation 
Rule (SI to IDL) 


Flist Hierarchy 


Transformation 
Rule (IDL to PI) 


accoimt.group.name 


R2 Vitria 
Account 


N/A 


N/A 


N/A String 


account, group.description 


R2 Vitria 
Account 


N/A 


N/A 


N/A String 


accoimt.group.status 


R2 Vitria 
Account 


Transformation to 
common value 
(see IDL doc) 




String to Integer 
Transform to COM 
LOV (see IDL doc) 


accountnewStatus 


R2 Vitria 
Account 


Transform to 
COM LOV(See 
IDL doc) 


0 

PIN_FLD_STATUSES 

ARRAY [0] 

1 

PIN FLD STATUS 
ENUM[0] 


String to Integer, 
then assign to 
appropriate member 
of emum list, as per 
the COM LOV (see 
IDL doc) 


account, accountid 


R2 Vitria 
Account 


N/A 


0 PIN FLD BILLINFO 

ARRAY [0] 

1 

PIN FLD ACCOUNT 
NO STR [0] 


N/A . 










account.billlnfo.payMethod 


R2 Vitria 
Account 


Transform to 
common value 
(See IDL doc) 


0 PIN FLD BILLINFO 

ARRAY [0] 

1 

PIN FLD BILL TYPE 
ENUM [0] 


String to Integer, 
then assign to 
appropriate member 
of emum list. Note: 
This field is used to 
determine whether 
or not the account is 
subordinate or not. 


account.billinfo.billMedia 


R2 Vitria 
Account 




0 PIN FLD PAYINFO 

ARRAY [0] 

1 

PIN FLD INHERITED 
INFO SUBSTRUCT 

[0] 

2 

PIN_FLD_INV_INFO 

ARRAY [0] 

3 

PIN FLD DELIVERY 
PREFER STR [0[ 


Vitria must translate 
the paper type to 
enumerator 


account.parentId 


R2 Vitria 
Account 


N/A 


0 PIN_FLD_BILLINFO 

ARRAY [0] 

1 

PIN FLD PARENT 
POID [0] 


This value will be 
used to retrieve 
parent id from Portal 


account.billinfo,currency 


R2 Vitria 
Account 


Transform to 
COM LOV (see 
IDL doc) 


0 PIN FLD BILLINFO 

ARRAY [0] 

1 

PIN FLD CURRENCY 
INT [0] 


String to Integer 
Transform to COM 
LOV (see IDL doc) 


account,billInfo.billFrequen 


R2 Vitria 


N/A 


0 PIN FLD BILLINFO 


Convert string to 



cy 


Account 




ARPIAY [0] 
1 

PIN FLD BILL WHE 
NINT[0] 


ENUM value (see 
IDL) 


account, contactlnfo. salutatio 
n 


KZ vitria 
Account 


XT / A 

Xn/A 


n 
U 

PIN FLD NAMEINFO 

ARRAY [0] 

1 

PIN FLD SALUTATIO 
N STR [0] 


XT/ A 

N/A 


account . companyName 


Kz Vitria 
Account 


Limit to 56 char 
in GUI 


u 

PIN FLD NAMEINFO 

ARRAY [0] 

1 

PIN FLD COMPANY 
STR [0] 


XT / A 

N/A 


accountxontactlnfo.homePh 
one 


R2 Vitria 
Account 


N/A 


0 

PIN FLD NAMEINFO 

ARRAY [0] 

1 

PIN FLD PHONES 
ARRAY [0...N] 
2 

PIN FLD TYPE 

ENUM[0] 

2 

PIN_FLD_PHONE STR 


In addition, convert 
field name to type 
(I.e. home, work, 
cell) 


account.accountType 


R2 Vitria 
Account 


'Billing 
Aggregator* = 
Unbillable 
•Billing* = Billable 


0 PIN FLD BILLINFO 

ARRAY [0] 

1 

PIN FLD BILL TYPE 
ENUM [0] 


Convert string to 
ENUM value (see 
IDL) 


account.billInfo.ccardExpire 
Date 


R2 Vitria 
Account 


Transform to 
common date 
format 


0 PIN FLD PAYINFO 

ARRAY [0] 

1 

PIN FLD INHERITED 
INFO SUBSTRUCT 
[0] 

z 

PIN FLD CC INFO 

ARRAY [0] 

3 

PIN FLD DEBIT EXP 
STR [0[ 


Can only accept 
MM/YY 
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1 


Add Product 


Siebel 


The "Add Produd event wHI send produ^ element) information to 
Vitria. This event Is triggered in the CRM application when the "Submit" 
order button is pressed for an order. A Siebel workflow sends the 
necessary account information to Vitria in XML format via an HTTP protocol 


2a. 1 


CreateOrder . Req uest 


OMS 


Vitria sends a Provision Request to OMS through the OMS target connection 
model which then translates it Into a CreateOrder. Request event. 


2a.2 


CreateOrder.Response 


OMS 


Upon provisioning, the OMS source connection model receives a 
CreateOrder.Response event from OMS which is then translated into a 
ProvlsionResponse. 


2a.3 


ServiceStatusNotification 


OMS 


OMS will also send to Vitria a ServiceStatusNotification event indicating the 
status of the account related to the ProvisionRequest 


3b. 1 


Find Customer 


Portal 


As a result of the Add Product system events, Vitria receives an account 
number. Portal uses the account number and the opcode 
PCM_OP_CUST_F!ND to determine the pold of the account that is getting 
new products added. 


"313.2 

111 


Find Service 


Portal 


If CRM does not send Portal service information for this business event, 
Infranet assumes the deal was intended to be attached at the account level, 
not at the service level. If CRM sends portal service information, it will be 
necessary to retrieve the service poid in order to attach the product to that 
sen^ice. Portal uses the Service Type, Service Login, Account Id and the 
opcode PCIVI_OP_SEARCH to detemnine the poid of the service. 
*Note: If CRM fails to send service information for a defined service-level 
deal, Portal will send back an error to Vitria. 


31i).3 


Find Deal 


Portal 


This system event uses the deal name to call the opcode 
PCM_OP_CUST„POL_GET_DEALS, This will retrieve all of the deals that 
are available. Internally, the wrapper opcode will iterate through each of the 
deals in order to match it to the deal's name. 




Add Deal 


Portal 


The final opcode that may be called is PCM„OP_BILL_PURCHASE_DEAL. 
This opcode will take the account poid, deal poid and optionally the service 
poid. This information will be used to add new deals to the account/service 
specified. 


3d. 5 


Acknowledgement 


Portal 


A response will be sent back fi*om Portal to Vitria indicating if the product 
has been successfully added or not. Vitria-IOM will transform this 
Acknowledgement event into an ServiceStatusNotification event to send to 
Siebei. 


4c. 1a 


Insert Account Component 


Arbor 


The insert account component event will be called when a new component 
is added at the account level. The component will be associated at the 
account level, and attached to the dummy package. 


4c. 1b 


Insert Service Component 


Arbor 


The insert service component event mW be called when a new component is 
added to an account at the service level. The component will be associated 
to the service instance. 


4c.2a 


Activate Account 
Component 


Arbor 


Once the account component has been inserted into the database, it must 
be activated individually in the activate APIs before billing can begin. Each 
component must be activated individually. 


4c.2b 


Activate Service 
Component 


Arbor 


Once the service component has been inserted into the database, it must be 
activated individually in the activate APIs before billing can begin. Each 
component must be activated individually. 


4c.3 


Acknowledgement 


Arbor 


A response will be sent back from Arbor to Vitria indicating that the 
component has been successfully entered or not. An acknowledgement 
event will be sent to the acknowledgement channel. 
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1 


Create Account 


Siebel 


The "Create Account" event will be used to send account 
information from Siebel to Vitria. The Create Account 
event is triggered in Siebel when the "Submit" order 
button is pressed for a new customer. A Siebel workflow 
sends the necessary account information to Vitria in XML 
format via an HTTP protocol. 


2a. 1 


Insert Account 


Arbor 


This event will be used to construct the account within 
Arbor by creating the acct API object and using the insert 
function to write the account information to the 
appropriate Arbor database. 


2a.2 


Insert Product 
Package 


Arbor 


Add a product package to an existing account 


2a.3 


Activate Product 
Package 


Arbor 


Activate the product package for the account. 


2a.4 


Insert Tax 
Exemption Info 


Arbor 


Tax exemption information is set for the account by 
populating the Tax Exemption API object and calling the 
insert function to write this infomnation to the appropriate 
Arbor database. There are four tax exemptions, one 
each for federal, state, county and city. 


2a.5 


Acknowledgement 


Arbor 


A response will be sent back from Arbor to Vitria 
indicating whether the account has been successfully 
created or not. 


ZU. 1 


Find Parent fFind 
Customer) 


Portal 


If a parent account number is passed across the Vitria 
interface, then the wrapper opcode will invoke 
PCM OP CUST^FIND in order to establish the poid 
value of the parent account. This event will also 
determine whether the parent is a member of a group. 


2b.2 


Commit Customer 


Portal 


Once all of the poids have been retrieved based on the 
information passed from the Vitria interface, the wrapper 
opcode calls PCM_OP_CUST_COMMIT_CUSTOMER in 
order to load all of the new customer infomiation into the 
Infranet database. 


2b.3 


Move Member 


Portal 


If the account is a non-Master account, then the wrapper 
opcode will call 

PCM OP BILL_GROUP_MUVE_MhMDtK to associaie 
the child account to a parent account 


2b.4 


Set Tax Info 


Portal 


When present, tax exemption information is passed with 
the account POID and associated with the account with 
the PCM_OP_CUST„SET_TAXINFO opcode. (Tax 
exemptions are not in scope for R3.0) 


2b.5 


Acknowledgement 


Portal 


A response will be sent back from Portal to Vitria 
indicating whether the account has been successfully 
created or not. 
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Channel Architecture Definition Table 



Channel Name 


Description 


Business Event 


Publisher 


Subscriber 


AccountChannel 


Events sent to this 
channel will pertain to 
creating, modifying, 
and disconnecting 
accounts. 


CreateAccount 
ModifyAccount 
UpdateAccountStatus 
ApplyAccountLevelAdjustment 


SiebelSourceC 
onnector 


Account 
Process 
Model 


ProvisionOrderChannel 


Events sent to this 
channel will pertain to 
installing and 
disconnecting products 
and services 


OrderHeader 

Add Service 

ModifyService 

CancelServices 

AddProduct 

CancelProduct 


SiebelSourceC 
onnector 


Order 

Processor 

Model 


ToSiebel 


All events that need to 
be published to the 
Siebel System 


ServiceStatusNotifi cation 
U pd ateP rod u ctStatus 


Service 

Processor 

Model 


SiebelTarge 
tCon nector 


Provisioning Request 


All events that need to 
be published to the 
Provisioning systems 


ProvisioningRequest 


Service 

Processor 

Model 


OMSTarget 
Connector 


rrovisioning rxcspoiibB 


published by 
Provisioning systems 


PrnviQinninnRp^r^nn^p 

t J ^VlOl^l III I 1 low 

ServiceStatusNotification 


OMSSourceCo 
nnector 

OMSTargetCon 
nector 


Service 

Processor 

Model 


Acknowledgennent 
Channel 


All Acknowledgements 
that an event was a 
success or a failure 


Acknowledgement 


ArborTargetCo 
nnector 

PortalTargetCo 
nnector 

SiebelTargetCo 
nnector 


Acknowledg 

mentToFile 

Service 

Processor 

Model 


Billing Channel 


All events that need to 
be published to the 
Billing systems 


CreateAccount 

ModifyAccount 

UpdateAccountStatus 

ApplyAccountLevelAdjustment 

AddService 

ModifyService 

CanceiService 

AddProduct 

CancelProduct 


Service 

Processor 

Model 


ToArbor 
Channel 
ToPortal 
Channel 


ToArbor 


All events that need to 
be published to the 
Arbor System 


CreateAccount 

ModifyAccount 

UpdateAccountStatus 

ApplyAccountLevelAdjustment 

AddService 

ModifyService 

CanceiService 

AddProduct 

CancelProduct 


Billing Channel 


ArborTarget 
Connector 


ToPortal 


All events that need to 
be published to the 
Portal System 


CreateAccount 

ModifyAccount 

UpdateAccountStatus 

ApplyAccou ntLevelAdj ustment 

AddService 

ModifyService 

CanceiService 

AddProduct 

CancelProduct 


Billing Channel 


Porta ITarget 
Connector 



